home *** CD-ROM | disk | FTP | other *** search
/ Teach Yourself VRML 2 in 21 Days / Teach Yourself VRML 2 in 21 Days.iso / mac / ISO9660 / 3rdparty / POLYTRAN / dos / PT_DOS.ZIP / DOC_1 / IMP_ALIA.1 < prev    next >
Encoding:
Text File  |  1996-06-13  |  3.0 KB  |  63 lines
  1. .so psroff.inc        # Include the macros needed for output to Postscript
  2. .TH Import-Alias-Triangle
  3. .SH NAME
  4. imp_alias \- Alias triangle geometry import filter
  5. .SH SYNOPSIS
  6. .PP
  7. This man page describes the options specific to the Alias Triangle
  8. import converter.
  9. .PP
  10. .SH EXAMPLE CONVERSION SYNTAX
  11. .PP
  12. To convert an Alias triangle file to Wavefront using the default parameters listed 
  13. in the setup.ini file:
  14. .IP
  15. pt -i alias -o wave filename.tri
  16. .PP
  17. To convert an Alias triangle file to VRML and override some of the default options 
  18. in setup.ini:
  19. .IP
  20. pt -i alias -in-alias-verbose = yes -o vrml filename.tri
  21. .PP
  22. .SH OVERVIEW
  23. .PP
  24. This geometry import converter reads in Alias Research triangle binary files 
  25. which can be output from Alias Power Animator/Studio/AutoStudio/Designer. 
  26. These files basically just contain raw geometry data in triangular format 
  27. with normals/colors/texture-uv coordinates per vertex. In addition the 
  28. file contains the texture filename associated with each polygon and the 
  29. structure of the file describes the hierarchy of the original scene. 
  30. .PP
  31. To output a triangle file from Alias click on File/Triangles/Options from 
  32. the Alias menu and select "Separators = on" then click on "Go".
  33. .PP
  34. .SH COMMAND LINE OPTIONS
  35. .PP
  36. The following options are specific to this import converter:
  37. .TP
  38. -i alias
  39. This is the optional command line option which specifies that the input data
  40. is in the Alias triangle file format. If not specified then the converter will try 
  41. to guess the input file's format from its file extension (.tri) 
  42. and then from the contents of its file. 
  43. .TP
  44. -in-alias-list-objects = [ on | off ]
  45. If this option is enabled then the input filter will print out the names of 
  46. the objects within the Alias triangle file. No data will be loaded in.
  47. .TP
  48. -in-alias-verbose = [ yes | no ]
  49. If set to 'yes' then this converter will print out verbose information 
  50. about the Alias triangle file as it is being parsed. No data will actually 
  51. be read into memory.
  52. .PP
  53. .SH NOTES
  54. .PP
  55. .IP
  56. 1. You must manually add the ".tri" extension to the end of these Alias files since Alias does not append this extension automatically.
  57. .IP
  58. 2. When Alias outputs the NURB surfaces to the triangle file it subdivides the NURB patches into polygons. The level of subdivision is set by the environment variables 'TRI_OUTPUT'. This should be set on the UNIX command line before entering Alias. For example: 'setenv TRI_OUTPUT 32' produces a highly tessellated triangle mesh. Higher numbers produce more polygons.
  59. .IP 
  60. 3. These triangle output format is a "poor man's" method of exporting geometry from Alias. The preferred technique is via SDL or the "wire" format. However, "wire" format is not publicly documented and the SDL format is complex to parse (due to the animation curves and NURB trimming curves). 
  61. .IP
  62. 4. Triangle format files contain vertex location, normal, color and texture u/v data for each vertex. In addition the file format describes the texture filename associated with each triangle.
  63.